package com.hello.system.mapper;

import java.util.List;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import com.hello.system.domain.UserTemplateUsage;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;

/**
 * 用户模板使用记录Mapper接口
 * 
 */
@Mapper
public interface UserTemplateUsageMapper extends BaseMapper<UserTemplateUsage>
{
    /**
     * 查询用户模板使用记录
     * 
     * @param id 用户模板使用记录主键
     * @return 用户模板使用记录
     */
    public UserTemplateUsage selectUserTemplateUsageById(Long id);

    /**
     * 查询用户模板使用记录列表
     * 
     * @param userTemplateUsage 用户模板使用记录
     * @return 用户模板使用记录集合
     */
    public List<UserTemplateUsage> selectUserTemplateUsageList(UserTemplateUsage userTemplateUsage);

    /**
     * 查询用户使用特定模板的记录
     * 
     * @param userId 用户ID
     * @param templateId 模板ID
     * @return 用户模板使用记录
     */
    public UserTemplateUsage selectUserTemplateUsageByUserIdAndTemplateId(@Param("userId") Long userId, @Param("templateId") Long templateId);

    /**
     * 新增用户模板使用记录
     * 
     * @param userTemplateUsage 用户模板使用记录
     * @return 结果
     */
    public int insertUserTemplateUsage(UserTemplateUsage userTemplateUsage);

    /**
     * 修改用户模板使用记录
     * 
     * @param userTemplateUsage 用户模板使用记录
     * @return 结果
     */
    public int updateUserTemplateUsage(UserTemplateUsage userTemplateUsage);

    /**
     * 删除用户模板使用记录
     * 
     * @param id 用户模板使用记录主键
     * @return 结果
     */
    public int deleteUserTemplateUsageById(Long id);

    /**
     * 批量删除用户模板使用记录
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteUserTemplateUsageByIds(Long[] ids);
    
    /**
     * 增加用户模板使用次数
     * 
     * @param userId 用户ID
     * @param templateId 模板ID
     * @return 结果
     */
    public int incrementUsageCount(@Param("userId") Long userId, @Param("templateId") Long templateId);

    /**
     * 查询用户模板总使用次数
     *
     * @param userId 用户ID
     * @return 结果
     */
    public Integer selectTotalUsageByUserId(@Param("userId") Long userId);
} 